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(i! 要】 本 文 基于 Revit 管线 批量 自动 标注 的 实际 工程 要 求 ,将 平行 管线 标注 分 为 无 变 径 标注 和 有 变 径 标注 两 
类 ,并 且 阐 述 了 会 导致 管线 发 生变 径 的 三 种 情况 ”针对 不 同 的 管线 排 布 情 况 分 别 杀 用 了 相对 应 的 管线 自动 标注 方 


法 .本文 还 提出 了 一 种 利用 引 垂 线 的 方法 解决 了 多 变 径 平行 管线 批量 标注 问题 


实验 结果 表明 ,该 类 方法 可 以 快 


速 高 效 地 对 管线 进行 标注 ,与 传统 的 标注 方法 相 比 ,简化 了 操作 ,提高 了 标注 效率 ,为 以 后 二 次 开发 提供 了 一 定 的 
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了 中 
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BIM 技术 的 兴起 是 计算 机 辅助 技术 在 建筑 行业 
的 又 一 次 发 展 。 在 现在 建筑 的 不 断 复杂 化 ,设计 要 
求 也 不 断 提 高 大 环境 下 ,Revit 软件 自身 所 带 的 功能 
已 不 能 满足 现在 建筑 设计 要 求 , 对 其 二 次 开发 已 迫 
在 眉 睫 。 

Revit 中 对 管线 的 标注 实际 上 是 机 电工 程 制图 
中 将 管线 的 直径 等 信息 以 注释 的 形式 直观 ,有效 地 
展现 出 来 的 一 种 工作 : 设计 师 在 绘制 机 电工 程 图 
纸 时 ,能 够 对 各 个 管线 进行 自动 标注 是 一 种 有 效 的 
缩短 制图 时 间 的 手段 。 标注 可 以 使 施工 人 员 更 加 
清楚 的 明白 各 个 管线 的 有 效 信息 ,其 重要 程度 不 言 
而 喻 。 但 是 ,利用 Revit 软件 中 自 带 标注 功能 进行 
标注 时 ,其 操作 难度 及 美观 性 都 不 能 够 达到 设计 师 
的 要 求 。 因 此 ,有 必要 设计 出 一 种 基于 Revit 的 自 
动 标注 插件 ,来 满足 设计 师 在 管线 标注 方面 的 需求 - 

Revit 二 次 开发 指 的 是 利用 C# 或 VB 语言 通过 
RevitAPI 提供 的 外 部 命令 接口 来 扩充 Revit 软件 功 
能 的 一 种 实际 应 用 ,是 基于 Revit 软件 对 该 软件 功 
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能 进行 扩展 的 一 项 研发 。 继 承 性 .特殊 性 .实用 性 、 
复杂 性 是 这 项 研发 的 特点 。 除 此 之 外 ,Revit 二 次 开 
发 不 仅 继承 了 软件 本 身 的 诸多 优点 ,还 可 以 针对 不 
同 的 绘图 人 员 的 需求 开发 出 不 同 特性 的 插件 ,从 而 
大 大 提高 出 图 的 效率 . 

Revit API 中 提供 了 两 类 Revit 二 次 开发 方式 ， 
外 部 命令 (External Command ) 方 式 和 外 部 应 用 (Ex- 
ternal Application ) 方 式 。 外 部 命令 继承 的 是 IExter- 
nalCommand 类 ,通过 安装 外 部 加 载 工 具 Add - in 
Manager 来 完成 插件 的 载 和 人 ,其 主要 作用 是 完成 某 
些 实际 的 功能 应 用 的 一 种 开发 。 另 一 种 方式 外 部 
应 用 开发 方式 ,继承 的 是 IExternalApplication 类 , 这 
种 方式 的 特点 是 通过 调用 OnStartup ( ) 函数 和 On- 
Shutdown( ) 函数 来 完成 该 插件 随 着 Revit 软件 的 启 
动 而 启动 , 随 着 Revit 软件 的 关闭 而 退出 。 继 承 外 
部 应 用 的 插件 一 般 情 况 是 对 菜单 或 者 工具 条 的 开 
发 ,并 且 需 要 在 Revit 自 启动 文件 夹 下 编写 相应 的 
addin 自 启动 文件 。 管线 自动 标注 方法 是 通过 Au- 
todesk 公司 提供 的 Revit API 中 封装 好 的 类 来 解决 
相应 的 问题 . 
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1 族 


族 是 一 个 包含 通用 属性 ( 称 作 参 数 ) 集 和 相关 
图 形 表示 的 图 元 组 ”。Autodesk Revit 族 主要 分 为 
内 建 族 、 系 统 族 和 标注 构件 族 三 类 。 管 线 自 动 标注 
族 属于 标注 构件 族 ,其 特征 具有 高 度 可 自 定 义 性 。 

Revit 管线 标注 功能 的 实现 就 是 通过 载 人 预先 
制作 好 的 族 来 完成 的 。 在 族 制作 中 可 以 选择 所 需 
要 添加 的 类 别 参 数 ,一 般 情况 下 ,管线 标注 只 需 标 
注 出 管线 的 参数 ,类 型 及 尺寸 大 小 等 信息 即 可 。 在 
这 里 ,本 文中 所 制作 的 管道 标注 族 添加 的 类 别 参数 
有 尺寸 和 标记 两 种 。 


2 Revit 管线 自动 标注 分 类 


2.1 管线 分 类 

Revit 管线 自动 标注 主要 分 为 单 根 管线 自动 标 
注 和 平行 管线 批量 自动 标注 两 大 类 。 其 中 单 根 标 
注 比较 简单 ,利用 Revit 软件 自 带 标注 功能 即 可 完 
Ro 本 文中 涉及 到 的 Revit MEP 管线 标注 是 基于 外 
部 命令 的 一 种 具有 批量 自动 标注 功能 的 插件 开发 。 
实际 操作 分 为 管线 无 变 径 自动 标注 和 管线 有 变 径 
自动 标注 两 种 情况 。 对 于 管线 没有 发 生变 径 的 情 
况 ,批量 自动 标注 方法 是 通过 获取 合适 的 标注 点 
后 ,以 该 标注 点 对 管线 做 投影 ,获取 每 根 管线 对 应 
标注 的 距离 及 引线 信息 ,然后 利用 尺寸 标注 方法 对 
管线 进行 标注 。 对 于 有 变 径 的 平行 管线 批量 标注 
问题 , 需 通过 标注 点 向 管线 引 垂 线 方法 获取 当前 一 
组 平行 管线 ,然后 再 利用 尺寸 标注 方法 进行 管线 
标注 。 
2.2 管线 发 生变 径 情况 

管线 发 生变 径 的 情况 可 以 分 为 三 种 :第 一 种 是 
管线 的 参数 ( 例如 管 径 大 小 ) 发 生变 化 ; 第 二 种 是 管 
线 的 排 布 情况 发 生变 化 ; 第 三 种 是 管线 发 生 分 支 
(例如 三 通 ,四 通 等 ) 变 化 。 发 生 不 同 的 变 径 有 不 同 
的 判断 方法 。 第 一 种 情况 可 以 通过 标注 点 向 管线 
引 垂 线 的 方法 将 管线 进行 分 组 标注 。 第 二 .三 两 种 
情况 当 直 接 通过 标注 点 对 管线 引 垂 线 时 , 由 于 管线 
排 布 方向 发 生变 化 或 者 有 三 通 或 四 通 情况 ,标注 点 
会 同时 向 多 根 管线 做 垂 线 ,从 而 导致 标注 会 发 生 混 
乱 ( 如 网 1)。 因此 ,对 于 后 两 种 情况 可 以 通过 获取 
管线 两 边 的 两 个 标注 点 的 方法 将 管线 再 分 组 然后 


万 方 数据 


进行 标注 ,这 样 就 可 以 避免 标注 混乱 的 情况 发 生 。 


图 1 多 变 径 管 线 标注 判断 


3 垂 线 法 解决 多 变 径 标注 问题 


多 变 径 平 行 管线 批量 标注 过 程 中 由 于 管线 的 
变 径 情 况 会 出 现 标注 引线 发 生 倾斜 的 问题 ,其 原因 
有 两 点 :一 是 通过 标注 点 对 管线 作 投影 ,其 投影 不 
在 管线 上 而 是 在 管线 的 延长 线 上 ; 二 是 当 管线 存在 
弯 管 .三 通 或 是 四 通 情况 时 ,通过 标注 点 作 投影 会 
同时 对 两 根 或 两 根 以 上 的 管线 同时 投影 ,这 也 会 导 
致 标注 引线 发 生 倾斜 。 对 于 以 上 两 种 情况 可 以 通 
过 分 组 筛选 的 方法 解决 :首先 获取 平行 管线 两 边 标 
注 点 各 一 个 并 做 一 条 直线 ,与 直线 有 交点 的 管线 分 
成 组 ,然后 再 通过 垂 线 法 解决 标注 引线 倾斜 问题 。 
对 于 文中 涉及 的 垂 线 法 有 如 下 定义 : 

设 管线 外 的 标注 点 为 P(pointX ,pointY ) ,管线 
的 两 个 端点 A(xl,y1),B(x2,y2) , 垂 足 坐 标 为 N 
(x,y) , 则 向 量 PN = Cx — pointX,y - pointY) ,AB = 
(x2-x1,32-yD ,AN = (x -xl,y - yD, HPN 5AB 
垂直 可 得 出 PN?4B =0, 即 : 

(x — pointX) (x2-x1) + (y - pointY) (y2-1) 20 
(D 
管线 位 置 有 以 下 几 种 情况 : 

(1) 平行 管 线 与 X 轴 平 行 , 垂 足 坐标 为 N 
(pointX ,y1) 。 

(2) 4105 2X 53 X WEE, EER N, 
pointY) 。 

(3 ) 平 行 管线 既 不 与 X 轴 平 行 也 不 与 X AE 
直 , 垂 足 坐 标 :NCk(x2-xl) +x1,k(y2-y1) +y1), 
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其 中 和 斜率 

_ 人 =xl Y= 

x2-xl — 32-1 © 
X EOD TS: 


UNTER (xl -pointX ) (x2-xl ) -( yl-pointY) (32-)1) 
(xl-32)" + (9132) 
9 
针对 上 述 情况 ,本文 提出 多 变 径 管线 批量 标注 
算法 ,具体 见 表 T: 


表 1 多 变 径 管线 批量 标注 算法 


管线 排序 ; 
获取 一 组 与 直线 相交 的 管线 信息 ; 


通过 乖 是 做 引线 并 对 管线 进行 逐一 标注 


4 快速 标注 


快速 标注 算法 是 基于 表 1 算法 的 改进 ,通过 管 
线 上 的 一 点 计算 出 对 应 的 标注 点 的 位 置 坐标 ,然后 
通过 重 线 法 解决 标注 问题 .如 网 2 所 示 , 快 速 标注 
管线 需要 解决 的 主要 问题 是 获取 通过 计算 获取 标 
注 点 PCx,y) 点 坐标 ,Q(xl.y1) ,R(x2,32) 是 管线 的 
两 个 端点 ,0 点 管线 上 标注 的 位 置 , 设 SRT = A 
(0 < A < D A 可 以 初始 化 其 值 ,在 标注 过 程 中 可 
以 初始 化 引线 的 长 度 即 h 的 值 ,然后 可 以 将 管线 与 
点 了 抽象 成 三 角形 (如 图 2) ,以 求 得 标注 点 的 坐标 。 


下 一- 一 — 
图 2 快速 标注 
在 这 里 管线 的 位 置 会 引起 相应 的 讨论 : 


(1) 管 线 与 X 轴 平 行 , 即 标注 点 P((1 -入 )xl + 
XQ, (1-2) yl &y2 &h) (12A >0,h>0)- 


万 方 数据 


(2) 管 线 与 X 轴 年 和 直 , 即 标注 点 P((1 -入 )xl + 
Ax2 +h,(1- 入 )yl+y2),(1> 入 >0,h>0)。 

(3) 管 线 既 不 与 X 轴 平 行 也 不 与 X disi jc. Bn 
可 知道 : 


QR - OP =0 @ 
IOPI =h © 


由 中 得 出 : 

G2-xD Gr 7 [C1 7 4x1 + AX2D * 2-1) 
(IX -Dyl £321) 20 

m oft: 


(x xl + Ax2D? & (y - Q1 - 40910 


A32) =k 
通过 计算 可 以 得 到 : 
Gy1232)7 
ywa yl l - E xd " 
V (1-2)! + (3152)! 
ÀAx2, 
其 中 (0 < A «I,h»0) 
Cxl-x2)h 
y = P y aay A 
(xl-x2)7 + (yl-y2)7 
A32, 


其 中 (0 «A <1,h>0), 

即 可 得 出 标注 点 P 的 坐标 

P 点 和 0 点 做 一 条 直线 即 为 标注 引线 ,再 利用 
尺寸 标注 方法 即 可 实现 自动 标注 。 


5 实验 结果 及 分 析 


根据 本 文 所 提供 的 标注 方法 ,利用 Autodesk 公 
司 的 产品 Autodesk Revit2014 进行 测试 , 使 用 
VS2010. NET 的 C# 语 言 进 行 代码 编写 : 编写 程序 
主要 有 如 下 步骤 : 1 ) 过 滤 出 当前 视图 中 所 有 管线 ; 
(2) 利 用 算法 1 实现 对 平行 管线 的 批量 标注 ; 3 ) 判 
断 是 否 结束 ,否则 继续 执行 步骤 2。 总 体 流程 见 
图 3- 

实验 测试 的 数据 来 自 某 一 实际 工程 中 的 Revit 
管线 标注 项 目 以 及 自主 构建 的 多 变 径 平 行 管线 组 。 
批量 标注 完成 效果 如 图 4 Bron - 

自动 批量 标注 与 Revit 软件 自 带 标注 效率 对 
比 :自动 批量 标注 所 需 花费 时 间 的 地 方 主要 是 分 别 
手动 选择 管线 上 方 和 下 方 两 个 标注 点 ,在 选择 完 标 
注 点 后 即 可 对 一 组 平行 管线 进行 批量 标注 ; Revit 
软件 自 带 标注 方法 只 能 一 根 一 根 的 进行 标注 ,其 效 
率 和 整齐 程度 都 不 及 本 文 提 出 的 批量 自动 标注 方 
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万 方 数据 


开始 


过 滤 出 当前 视 
图 中 所 有 管线 


. 


、 管 线 数量 为 0 


| 
Y 
获取 两 个 标注 
点 并 过 这 两 点 
一 -一 > 做 一 条 直线 ， 
但 不 将 其 实例 
化 


ER ERMEE p: 
到 管线 的 垂 线 


_1 


管线 参数 、 型 号 等 
信息 标注 


DN125 aa 


图 5 某 工程 实际 项 目 
( 暖 通 水 系统 平行 管线 批量 标注 ) 
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法 。 文 中 提 到 的 快速 标注 在 标注 效率 上 是 最 高 的 ， 
在 自动 批量 标注 方法 上 省 去 了 手动 选择 标注 点 的 
时 间 , 但 其 标注 位 置 是 统一 周 定 在 管线 的 某 点 处 
的 ,其 美观 及 适合 度 不 及 自动 批量 标注 。 具 体 对 比 
见 表 2。 


表 2 手动 标注 与 自动 标注 效率 对 比 
无 变 径 多 变 径直 管 ”多 变 径 弯 管 ”快速 标注 
手动 一 般 较 低 较 低 


表 3 手动 标注 与 自动 标注 美观 程度 对 比 
ELB — “多 变 径直 管 SERSE ”快速 标注 


手动 ”一 般 一 般 一 般 
自动 ” 较 好 较 好 较 好 一 般 
6 总 结 


本 文 主要 阐述 了 基于 Revit 软件 下 管线 批量 自 
动 标注 的 实现 方法 ,同时 对 软件 自 带 的 标注 方法 做 
了 简单 的 评析 。 管 线 的 自动 标注 主要 是 针对 单个 
管线 的 自动 标注 和 批量 管线 的 自动 标注 两 种 情况 ， 
其 中 批量 标注 又 可 细 分 为 单个 管线 多 变 径 标注 .无 
变 径 平行 管线 批量 标注 和 有 变 径 平行 管线 批量 标 
注 。 这 几 种 标注 情况 基本 上 涵盖 了 目前 绘图 工程 
师 所 需要 标注 的 全 部 情况 。 在 多 变 径 管线 批量 标 
注 中 本 文 提 出 了 利用 做 垂 线 的 方法 将 管线 进行 分 
组 ,从 而 解决 了 标注 引线 倾斜 的 问题 。 

本 文 所 提出 的 Revit 二 次 开发 生成 插件 进行 批 
量 标注 的 方法 比 使 用 Revit 自身 交互 界面 标注 方法 
效率 有 大 幅度 的 提高 , 且 具 有 明显 的 针对 性 , 使 标 
注 更 具 智 能 化 ,不 仅 简 化 了 操作 , 还 满足 了 一 些 绘 
图 工程 师 的 特殊 需求 ,从 而 缩短 了 工程 周期 ,节约 
了 时 间 和 成 本 ,为 Revit 在 管线 标注 方面 或 其 他 应 
用 领域 提供 了 一 些 借鉴 。 
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Realization of Revit Pipeline Auto-labeling Method 


Li Changhua, Li Tong, Zhou Fangxiao, Cui Huanhuan 


( Xi' an University of Architecture and Technology, Xi' an 710000, China) 


Abstract ; Based on the actual engineering requirements of Revit pipeline auto-labeling, this paper divides par- 
allel pipeline labels into two categories of no-adjustable and adjustable parallel pipeline labels and describes three 
situations which will lead to pipeline diameter changes. In addition, the paper puts forward a method of using lead 
vertical to solve the problem of the changeable diameter parallel pipes labeling. The experimental results show that : 
this kind of labeling methods greatly increase labeling efficiency, and compared to the use of Revit interactive inter- 
face, they simplifies the operation, improve the labeling efficiency and provide some experiences for secondary de- 
velopment in the future. 


Key Words: Revit Secondary Development; Building Information Modeling; Pipeline Labeling 
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Realization of Cross-platform Virtual 3D Construction Progress System 


Rao Pingping, Shao Zhaotong, Zhao Linxue 


( School of Environment and Architecture, University of Shanghai for Science and Technology , 
Shanghai 200093 , China) 


Abstract : Engineering construction needs visual progress management tools to integrate BIM and VR to develop 
a visualized and multi-terminal construction progress demonstration system with rich information. Building the 
standard construction model with Revit, this article modifies the texture of materials using 3DMAX and then imports 
the model to Unity3D so as to develop a cross-platform construction progress system. Model information in Revit is 
transmitted to Unity3D in IFC format, which can be easily released to the PC, Web and mobile terminal and pro- 
vide better service for construction management. 


Key Words: BIM ; VR ; Cross-platform ; Construction Progress 


万 方 数据 


